home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Auge 4000 / Auge 4000 #78 (1994-04-30)(Amiga User Gruppe Einzugsgebiet 4000).zip / Auge 4000 #78 (1994-04-30)(Amiga User Gruppe Einzugsgebiet 4000).adf / CycleToMenu-2.0 / English / CycleToMenu.doc next >
Text File  |  1994-03-24  |  10KB  |  346 lines
  1. ----------------------------------------------------------------------------
  2.  
  3.                               CycleToMenu 2.0
  4.  
  5. ----------------------------------------------------------------------------
  6.  
  7.  
  8. The files in this archive were written by Federico Giannici and are freely
  9. distributable as long as the archive remains intact, and only a nominal fee
  10. is charged for its distribution.
  11.  
  12. This software is provided "AS IS" without warranty of any kind, either
  13. expressed or implied. By using it, you agree to accept the entire risk as to
  14. the quality and performance of the program.
  15.  
  16.  
  17. This program is CardWare: if you like it, send a postcard of your country to
  18. the author. Comments, suggestions, donations and bug reports are welcome.
  19.  
  20. The author's address is:
  21.  
  22.     Federico Giannici
  23.     Viale Francia 4
  24.     90146 Palermo
  25.     Italy
  26.  
  27.  
  28. E-Mail: mc4080@mclink.it
  29.  
  30.  
  31.  
  32.  
  33.     OVERVIEW
  34. ~~~~~~~~~~~~~~~~
  35. CycleToMenu is a commodity that turns the standard cycle gadgets into popup
  36. menus or "expanding" gadgets. This way, selecting the desired option is
  37. easier and faster.
  38.  
  39. Note that clicking on the arrow image on the left of the cycle gadgets will
  40. make them behave in the usual way. This feature allows you to step straight
  41. to the next item. It can also be useful in low-memory situations or when the
  42. popup menu is too long to completely fit inside the screen.
  43.  
  44.  
  45.  
  46.     ENHANCEMENTS FROM CYCLETOMENU 1.10
  47. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  48. · The popup menus' look&feel is now highly configurable
  49. · Added a font&resolution-sensitive configuration window
  50. · Complete "localization" of the program (AmigaOS 2.1 required)
  51. · Parameters can be used both from Workbench and Shell
  52. · It's now possible to quit the program
  53.  
  54.  
  55.  
  56.     REQUIREMENTS
  57. ~~~~~~~~~~~~~~~~~~~~
  58. · AmigaOS Release 2.0
  59. · AmigaOS Release 2.1 is required for the localization
  60.  
  61.  
  62.  
  63.     INSTALLATION
  64. ~~~~~~~~~~~~~~~~~~~~
  65. Installation is very simple: open the drawer of the language you want to use
  66. and double-click the installation icon.
  67.  
  68. An AmigaDOS script will start and copy the CycleToMenu program into the
  69. WBStartup drawer of your Workbench partition (or disk). Moreover, if the
  70. selected language is different from English, the "catalog" file will be
  71. copied in the appropriate directory, so that CycleToMenu will be able to use
  72. that language.
  73.  
  74. Note that CycleToMenu has effect only on those cycle gadgets created while
  75. CycleToMenu was already running. So, it's very important to launch
  76. CycleToMenu as soon as possible. To achieve this, the default CycleToMenu's
  77. STARTPRI ToolType is set to a high value (100). Workbench uses this ToolType
  78. to decide in which order the programs in WBStartup shall be executed.
  79.  
  80.  
  81.  
  82.     CHANGING THE CONFIGURATION
  83. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  84. Once CycleToMenu is running, you can open its configuration window in three
  85. different ways:
  86.  
  87. · By means of the hot-key (default is "control alt y")
  88. · Through the Exchange program
  89. · Launching CycleToMenu again
  90.  
  91. You can configure the menus look and behavior by means of the window
  92. gadgets. You can immediately see the new behavior experimenting with the
  93. three test gadgets at the bottom of the window.
  94.  
  95. The "Save" menu item may be used to save the configuration.
  96.  
  97.  
  98.  
  99.     GADGETS
  100. ~~~~~~~~~~~~~~~
  101.  
  102.   Make zoom
  103.   ---------
  104. If this is selected, the popup menus will smoothly unfold.
  105.  
  106.  
  107.   Min duration
  108.   Max duration
  109.   ------------
  110. These two gadgets control the duration of the zoom (expressed as fraction of
  111. a second). The actual duration is proportional to the number of items in the
  112. popup menu. The minimum duration is obtained when the menu has only two
  113. items. The maximum duration is reached with ten or more items.
  114.  
  115.  
  116.   Use screen font
  117.   ---------------
  118. By default, CycleToMenu uses the same font of the cycle gadget. If this
  119. option is active, it will use the current screen font.
  120.  
  121.  
  122.   Min font size
  123.   -------------
  124. Usually, CycleToMenu uses the same font of the cycle gadget. Unfortunately,
  125. many programs use some quite little font (e.g. topaz/8). If the cycle
  126. gadget's font is smaller than the value specified here, CycleToMenu will use
  127. the screen font (only if it is taller than the gadget's one). If you want to
  128. always use the cycle gadget's font, set this value to "0".
  129.  
  130.  
  131.   Min items
  132.   ---------
  133. If the cycle gadget has a number of items lower than the specified value,
  134. CycleToMenu doesn't open its popup menu. So, for example, a good value can
  135. be "3". In this way, no popup menu is opened for cycle gadgets with only two
  136. items.
  137.  
  138.  
  139.   Menu look
  140.   MagicMenu look
  141.   Gadget look
  142.   --------------
  143. This gadgets select one of the three different kind of popup menus.
  144.  
  145. Menu look - simulate the usual Intuition's menus.
  146.  
  147. MagicMenu look - uses the same look of "MagicMenu" (MagicMenu is copyright
  148. by Martin Korndörfer).
  149.  
  150. Gadget look - make the popup menus look like gadgets. The idea is that a
  151. cycle gadget is a little "window" in the list of all possible gadget's
  152. values. When the user click on the gadget, the window expands revealing the
  153. complete list of all possible values.
  154.  
  155.  
  156.   Force NewLook menu
  157.   ------------------
  158. This gadget forces CycleToMenu to always use the NewLook menus introduced
  159. with AmigaOS 3.0. Under AmigaOS 2.x, CycleToMenu tries to emulate this new
  160. look as close as possible.
  161.  
  162.  
  163.   Double border
  164.   -------------
  165. This Gadget is used to simulate the "Double Borders" option of MagicMenu.
  166.  
  167.  
  168.   Inner border
  169.   ------------
  170. This option adds an empty border between the external border of the menu and
  171. the items inside (the difference is more evident with the current (reversed)
  172. item).
  173.  
  174.  
  175.   Recess current item
  176.   -------------------
  177. If this option is active, the current item is shown recessed.
  178.  
  179.  
  180.   Test gadgets
  181.   ------------
  182. These three gadgets have no influence at all on the popup menus. You may use
  183. them to test the effects of the changes you make to the configuration. In
  184. order to test the configuration under the wider situations, the three
  185. gadgets use a different font (indicated above them) and a different number
  186. of items.
  187.  
  188.  
  189.  
  190.     MENUS
  191. ~~~~~~~~~~~~~
  192.  
  193.   Save
  194.   ----
  195. This item saves the current configuration into the ToolTypes. Note that you
  196. have to launch CycleToMenu from Workbench (or WBStartup) to have the
  197. ToolTypes to take effect.
  198.  
  199.  
  200.   About
  201.   -----
  202. Opens a requester with some information about the program and its author.
  203.  
  204.  
  205.   Hide
  206.   ----
  207. Closes the configuration window. The programs keeps running with the current
  208. configuration.
  209.  
  210.  
  211.   Quit
  212.   ----
  213. It closes the configuration window and quits the program. The cycle gadgets
  214. will resume the usual behaviour.
  215.  
  216.  
  217.  
  218.     PARAMETERS & TOOLTYPES
  219. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  220. CycleToMenu uses the same names for both the Shell parameters and the
  221. Workbench ToolTypes.
  222.  
  223. Usually, you will not directly modify these parameters, as it's much more
  224. comfortable to change them by means of the configuration window. The only
  225. parameters that you have to change by hand are CX_POPKEY and PUBSCREEN.
  226.  
  227.  
  228.   CX_POPKEY                    Default: control alt y
  229.   ---------
  230. This is the hot-key, the input sequence that opens the window if it is
  231. closed, or brings it to the front if it is already open. Refer to the Amiga
  232. User Manual for a complete specification of the recognized keywords.
  233.  
  234.  
  235.   CX_POPUP                     Default: YES
  236.   --------
  237. This tells if the configuration window should be opened when the program is
  238. run for the first time. Usually, you should set this parameter to NO.
  239.  
  240.  
  241.   CX_PRIORITY                  Default: 0
  242.   -----------
  243. This is the priority of the commodity handler used for the hot-key. Usually,
  244. you will not need to change this.
  245.  
  246.  
  247.   PUBSCREEN                    Default: the Workbench screen
  248.   ---------
  249. This is the name of the public screen where to open the configuration
  250. window.
  251.  
  252.  
  253.   MAKEZOOM                     Default: YES
  254.   --------
  255. This parameter corresponds to the "Make zoom" gadget status.
  256.  
  257.  
  258.   MINZOOMDURATION              Default: 8
  259.   ---------------
  260. This parameter corresponds to the "Min zoom duration" gadget value.
  261.  
  262.  
  263.   MAXZOOMDURATION              Default: 16
  264.   ---------------
  265. This parameter corresponds to the "Max zoom duration" gadget value.
  266.  
  267.  
  268.   USESCREENFONT                Default: NO
  269.   -------------
  270. This parameter corresponds to the "Use screen font" gadget status.
  271.  
  272.  
  273.   MINFONTSIZE                  Default: 0
  274.   -----------
  275. This parameter corresponds to the "Min font size" gadget value.
  276.  
  277.  
  278.   MINITEMS                     Default: 0
  279.   --------
  280. This parameter corresponds to the "Min items" gadget value.
  281.  
  282.  
  283.   LOOK                         Default: GADGET
  284.   ----
  285. This parameter corresponds to the three "look" gadgets status. There are
  286. three possible keywords for this parameter:
  287.  
  288. MENU - corresponds to the "Menu look" option
  289.  
  290. MAGICMENU - corresponds to the "MagicMenu look" option
  291.  
  292. GADGET - corresponds to the "Gadget look" option
  293.  
  294.  
  295.   FORCENEWLOOKMENU             Default: NO
  296.   ----------------
  297. This parameter corresponds to the "Force NewLook menu" gadget status.
  298.  
  299.  
  300.   DOUBLEBORDER                 Default: NO
  301.   ------------
  302. This parameter corresponds to the "Double border" gadget status.
  303.  
  304.  
  305.   INNERBORDER                  Default: NO
  306.   -----------
  307. This parameter corresponds to the "Inner border" gadget status.
  308.  
  309.  
  310.   RECESSCURRENT                Default: NO
  311.   -------------
  312. This parameter corresponds to the "Recess current item" gadget status.
  313.  
  314.  
  315.  
  316.     LIMITATIONS
  317. ~~~~~~~~~~~~~~~~~~~
  318. CycleToMenu works with every program that uses the standard GadTools' cycle
  319. gadgets, but it doesn't work with those programs that simulate such gadgets
  320. (i.e., almost only those programs that work also with AmigaOS 1.3).
  321.  
  322. Some badly written programs don't use the IntuiMessage->Code field but they
  323. simply assume that every time the gadget is clicked it makes a step forward.
  324. This is absolutely wrong! As mentioned above, you can avoid this problem
  325. clicking on the arrow image of the gadget making it behave in the usual way.
  326.  
  327.  
  328.  
  329.     ACKNOWLEDGMENTS
  330. ~~~~~~~~~~~~~~~~~~~~~~~
  331. As usual, I have to thank my beta testers, whose help has been invaluable
  332. during the development of this program: Nicola Salmoria, Dante Profeta and
  333. Stefano Iacus.
  334.  
  335. Special thanks go to Reinhard Spisser for the German translation and Ronald
  336. van Eijck for the Dutch one.
  337.  
  338. I also want to thank all the people which E-Mailed me useful suggestions and
  339. bug reports.
  340.  
  341.  
  342.    __
  343.   |-
  344.   |ederico
  345.  
  346.